home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_perl.idb / usr / freeware / catman / p_man / cat3 / lib.Z / lib
Encoding:
Text File  |  1998-10-28  |  3.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      lllliiiibbbb((((3333))))         22223333////JJJJuuuullll////99998888 ((((ppppeeeerrrrllll 5555....000000005555,,,, ppppaaaattttcccchhhh 00002222))))        lllliiiibbbb((((3333))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       lib -    manipulate @INC    at compile time
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           use lib LIST;
  13.  
  14.           no lib LIST;
  15.  
  16.  
  17.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.       This is a small simple module    which simplifies the
  19.       manipulation of @INC at compile time.
  20.  
  21.       It is    typically used to add extra directories    to perl's
  22.       search path so that later use    or require statements will
  23.       find modules which are not located on    perl's default search
  24.       path.
  25.  
  26.       AAAADDDDDDDDIIIINNNNGGGG DDDDIIIIRRRREEEECCCCTTTTOOOORRRRIIIIEEEESSSS TTTTOOOO    @@@@IIIINNNNCCCC
  27.  
  28.       The parameters to use    lib are    added to the start of the perl
  29.       search path. Saying
  30.  
  31.           use lib LIST;
  32.  
  33.       is _a_l_m_o_s_t the    same as    saying
  34.  
  35.           BEGIN { unshift(@INC, LIST) }
  36.  
  37.       For each directory in    LIST (called $dir here)    the lib    module
  38.       also checks to see if    a directory called $dir/$archname/auto
  39.       exists.  If so the $dir/$archname directory is assumed to be
  40.       a corresponding architecture specific    directory and is added
  41.       to @INC in front of $dir.
  42.  
  43.       If LIST includes both    $dir and $dir/$archname    then
  44.       $dir/$archname will be added to @INC twice (if
  45.       $dir/$archname/auto exists).
  46.  
  47.       DDDDEEEELLLLEEEETTTTIIIINNNNGGGG DDDDIIIIRRRREEEECCCCTTTTOOOORRRRIIIIEEEESSSS FFFFRRRROOOOMMMM @@@@IIIINNNNCCCC
  48.  
  49.       You should normally only add directories to @INC.  If    you
  50.       need to delete directories from @INC take care to only
  51.       delete those which you added yourself    or which you are
  52.       certain are not needed by other modules in your script.
  53.       Other    modules    may have added directories which they need for
  54.       correct operation.
  55.  
  56.       By default the no lib    statement deletes the _f_i_r_s_t instance
  57.       of each named    directory from @INC.  To delete    multiple
  58.       instances of the same    name from @INC you can specify the
  59.       name multiple    times.
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 10/23/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      lllliiiibbbb((((3333))))         22223333////JJJJuuuullll////99998888 ((((ppppeeeerrrrllll 5555....000000005555,,,, ppppaaaattttcccchhhh 00002222))))        lllliiiibbbb((((3333))))
  71.  
  72.  
  73.  
  74.       To delete _a_l_l    instances of _a_l_l the specified names from @INC
  75.       you can specify ':ALL' as the    first parameter    of no lib. For
  76.       example:
  77.  
  78.           no lib qw(:ALL .);
  79.  
  80.       For each directory in    LIST (called $dir here)    the lib    module
  81.       also checks to see if    a directory called $dir/$archname/auto
  82.       exists.  If so the $dir/$archname directory is assumed to be
  83.       a corresponding architecture specific    directory and is also
  84.       deleted from @INC.
  85.  
  86.       If LIST includes both    $dir and $dir/$archname    then
  87.       $dir/$archname will be deleted from @INC twice (if
  88.       $dir/$archname/auto exists).
  89.  
  90.       RRRREEEESSSSTTTTOOOORRRRIIIINNNNGGGG OOOORRRRIIIIGGGGIIIINNNNAAAALLLL @@@@IIIINNNNCCCC
  91.  
  92.       When the lib module is first loaded it records the current
  93.       value    of @INC    in an array @lib::ORIG_INC. To restore @INC to
  94.       that value you can say
  95.  
  96.           @INC = @lib::ORIG_INC;
  97.  
  98.  
  99.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  100.       FindBin - optional module which deals    with paths relative to
  101.       the source file.
  102.  
  103.      AAAAUUUUTTTTHHHHOOOORRRR
  104.       Tim Bunce, 2nd June 1995.
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 10/23/98)
  130.  
  131.  
  132.  
  133.